home *** CD-ROM | disk | FTP | other *** search
-
-
-
- END
- The END command HALTS execution of the script file and EXITS.
-
- GOTO LABEL
- The GOTO statement jumps to location where LABEL can be found
- in the script file.
-
- IFINT LABEL
- IFINT tests to see if the next image to be loaded is a GIF
- Interlaced file. If so, control jumps to LABEL.
-
- IF-LAST-FILE LABEL
- IF-LAST-FILE tests to see if there are NO MORE files to be
- processed. If there are no more files in the list, control
- jumps to LABEL.
-
- IF>=320X200 LABEL
- IF>=320X200 tests the next image size. If the next image is
- greater than or equal to 320X200 resolution, control jumps to
- LABEL.
-
- IF>=640X400 LABEL
- IF>=640X480 LABEL
- IF>=800X600 LABEL
- IF>=1024X768 LABEL
- The above tests are similar in nature to the IF>=320X200.
-
- IFBMP LABEL
- IFGIF LABEL
- IFPCX LABEL
- IFPIC LABEL
- These test for the file extension of the next file to load. If
- the extension matches, control jumps to LABEL.
-
- IFEXIST Filename LABEL
- If the filename indicated EXISTS in the currently selected
- directory then control jumps to LABEL.
-
- IFBUTTON-L LABEL
- If mouse control is ON, IFBUTTON-L detects if the LEFT mouse
- button was pressed to quit out of a picture. If the LEFT
- button was pressed, control jumps to LABEL
-
- IFBUTTON-R LABEL
- IFBUTTON-C LABEL
- These commands are similar to IFBUTTON-L, but testing for the
- RIGHT and CENTER buttons instead.
-
- IF V{1-10}{<,>,=}{###} LABEL
- The IF command tests the value of one of the 10 variables
- allowed. The test can be <(less than) or >(greater than) or
- =(equal). The ### is a number to test against. LABEL is where
- control jumps if the test is true. For example: "IF V4>10
- :MORE" This statement checks to see if variable 4 is greater
- than 10. If so control jumps to ":MORE".
-
- GOSUB LABEL
- This allows a procedure (routine, function) with the name
- LABEL to be executed. Once the routine is finished, control
- transfers back to the statement following the GOSUB LABEL.
- NOTE: The called procedure must end with a SUB-END statement.
-
- SUB-END
- This statement indicates that the end of the subroutine is
- found. Control will transfer back to where the calling GOSUB
- statement was.
-
-
-
- DISPLAY V{1-10}
- This displays on the screen the current value of any of the 10
- variables that you can manipulate. For example: "DISPLAY V2"
- would cause the contents of V2 to be displayed on the screen.
-
- ECHO text message
- This command allows you to print any text on the screen (much
- like the DOS ECHO command). Any text can be displayed. For
- example: "ECHO Have a nice day!" would result in "Have a nice
- day!" displayed on your screen. The ECHO command also allows
- for system variables to be displayed in the message. Enclose
- any system variable within % in the message. For example:
-
- ECHO %FILE_NAME% has %IMAGE_COLORS% colors in it!
-
- This would display something like:
-
- GIRL.GIF has 256 colors in it!
-
- The allowable system variables are described below in the SET
- command. There is one (1) additional system variable that the
- ECHO command can use that the SET command can't. It's the
- "FILE_NAME" system variable. The reason the SET command can't
- use it is because it's NOT a number!
-
- HINT: By using system variables in the ECHO command and using
- the PRINTER-ON command, you can essentially produce reports
- about your picture files! (See the GIFV.SLU script file for
- details.)
-
- SET V{1-10} {###,+,-,system}
- This command sets the value of any of the 10 variables allowed
- in the script language to a particular value. For example:
- "SET V3 100". This would set V3 to 100. You can also increment
- and decrement variables. For example: "SET V5 +". This would
- add 1 to the value of V5 and "SET V1 -" would subtract 1 from
- the value of V1. You can also set your variables to some of
- the various SYSTEM settings. For example: If you wanted V2 to
- contain the size of the next file to process, you would say
- "SET V2 FILE_SIZE". Below is a list of all system variables.
-
- System variables List
-
- DEBUG_SWITCH
- If the DEBUG-ON option is turned on, this will be
- equal to 1, otherwise it will be equal to 0.
-
- PRINTER_SWITCH
- If the PRINTER-ON option is turned on, this will be
- equal to 1, otherwise it will be equal to 0.
-
- RES_LOCK_SWITCH
- If the RES-LOCK option is turned on, this will be
- equal to 1, otherwise it will be equal to 0.
-
- MOUSE_CONTROL_SWITCH
- If the MOUSE-CONTROL-ON option is turned on, this
- will be equal to 1, otherwise it will be equal to 0.
-
- RES_X
- This returns the value of the width of the next
- image to load.
-
- RES_Y
- This returns the value of the height of the next
- image to load.
-
- FILE_NUMBER
- This returns the number of files already processed
- in a particular path.
-
- FILE_ERROR
- This returns the error number of the last file
- operation (File-Copy, File-Move, File-Delete, File-
- Rename.) The meaning of the different values that
- FILE_ERROR can have are listed below:
- 0 File operation completed OK
- 1 Source file can't be found
- 2 Target area FULL, Subdirectory by same
- name, or Target NOT a valid drive.
- 3 Target area doesn't exist or Target drive
- full
- 4 Read/Write ERROR on file
- 5 NOT Enough Memory
- 6 NOT USED
- 7 Source and Target are the SAME
- 8 NOT USED
- 9 FILE-RENAME used invalid WILDCARDing
-
- LINE_NUMBER
- This returns the line number in the script file that
- the set command is on.
-
- DELAY
- This returns the delay time for the slides to wait
- after showing the image.
-
- RESOLUTION
- This returns what resolution number is currently
- selected. It's only useful if RES-LOCK is turned on.
- The numbers range from 1 to ??. Usually there are
- about 3 to 6 resolutions available depending on your
- Super VGA capabilities.
-
- FILE_SIZE
- This returns the file size of the next file to be
- processed.
-
- IMAGE_COLORS
- This returns the number of colors in the file. This
- would be 2 for black & white pictures, 16 for 16
- color files and 256 for 256 color files. If the
- image has 24BIT color then IMAGE_COLORS will have 24
- stored in it.
-
- V_#
- Where # is 1 thru 10. This means you can set any
- variable to the value of any other variable. For
- example: "SET V2 V_1" This sets variable 2 to the
- value in variable 1.
-
-
- CHANGE-PATH {PATH, %1-%9)
- This command changes the path to load files from the path
- indicated by PATH. For example: "CHANGE-PATH *.GIF" would
- point the file list to the current directory. "CHANGE-PATH
- F:\PICTURES\*.GIF" would point to the F:\PICTURES directory
- and only select GIF files.
-
- NOTE: You can also use the %1 through %9 instead of a valid
- path. In this case the path will be taken from the program
- command line (very powerful!). So for example:
-
- C>GIFV /P:R G:\*.* E:\CAT\*.GIF
-
- If the script file called GIFV.SLR had a CHANGE-PATH %1 in it
- then "G:\*.*" would be used instead. If it had a CHANGE-PATH
- %2 then E:\CAT\*.GIF would be used. You can have up to 9
- different selections.
-
- NOTE: As in the normal menu operation of GIF-REED, you can use
- the special wildcard of *.? to specify ALL image formats that
- GIF-REED recognizes. This is powerful in the fact that it is
- BETTER than using *.*. This is because *.* will get ALL files
- including files that aren't image files (.EXE, .COM, etc...).
-
-
- FILE-COPY Destination LABEL
- This command allows you to take the next file in the list to
- be processed and copy it to a new filename or even a new drive
- and/or path. If there is an error in copying, control jumps to
- LABEL. See the system variable called FILE_ERROR.
-
- FILE-MOVE Destination LABEL
- This command allows you to take the next file in the list to
- be processed and move it to a new path or even a new drive
- and/or path. If there is an error in moving, control jumps to
- LABEL. See the system variable called FILE_ERROR.
-
- FILE-DELETE LABEL
- This command allows you to delete the next file to be
- processed. If there is an error in deleting, control jumps to
- LABEL. See the system variable called FILE_ERROR.
-
- FILE-RENAME FileName LABEL
- This command allows you to rename the next file to be
- processed. You can specify either a regular filename or you
- can WILDCARD the filename. See your DOS manual about WILDCARDS
- in filenames if you are not familiar with the term. For
- example "FILE-RENAME *.XXX" This would take the next file and
- rename it to the same filename but .XXX for the file
- extension! "FILE-RENAME X*.*" This would take the next file
- and rename it so that the 1st letter will be a X and the rest
- of the file name would remain intact! If there is an error in
- renaming, control jumps to LABEL. See the system variable
- called FILE_ERROR.
-
- SUB-CREATE {Path,%1-%9} LABEL
- This command creates a directory with the path specified by
- PATH. For example: "SUB-CREATE NEWGIFS" would create a
- subdirectory called NEWGIFS in the current path. You can
- change paths by issuing the CHANGE-PATH command. "SUB-CREATE
- E:\CAT :ERROR" would create a subdirectory called \CAT on the
- ROOT of drive E:. If there was an error in creating the
- directory, control jumps to LABEL.
-
- NOTE: You can also use the %1 through %9 instead of a valid
- path. In this case the path will be taken from the program
- command line (very powerful!). So for example:
-
- C>GIFV /P:R NEWGIFS E:\CATF
-
- If the script file called GIFV.SLR had a SUB-CREATE %1 in it
- then "NEWGIFS" would be used to create a directory instead of
- %1. If it had a SUB-CREATE %2 then E:\CAT would be used. You
- can have up to 9 different selections.
-
- LOAD filename
-
- This command will load a specific picture file onto your
- screen.
-
- LOADNEXT LABEL
- This command loads the next file from the selected path used
- by the CHANGE-PATH PATH command. The picture is also
- displayed. If no more files exist (at end of list) control is
- transferred to LABEL.
-
- LOADPREV LABEL
- This command is similar to LOADNEXT except the files are
- loaded in reverse order. If you try to go too far backwards,
- control jumps to LABEL.
-
- SKIPNEXT LABEL
- The same as LOADNEXT except the picture is NOT displayed. The
- file pointer is merely incremented to point to the next file
- in the list.
-
- SKIPPREV LABEL
- The same as LOADPREV except the picture is NOT shown. The file
- pointer is merely decremented.
-
-
-
- SLIDE-TYPE-NORMAL
- This command puts the slide show into normal viewing mode.
- That is to say, NO special effects.
-
- SLIDE-TYPE-BLIND
- This command makes the images appear on the screen with a
- venetian blind effect.
-
- SLIDE-TYPE-FADE
- This command makes the images Fade IN/OUT on the screen.
-
- SLIDE-TYPE-EXPAND
- This command makes the images Expand on the screen.
-
- SLIDE-TYPE-MERGE
- This command makes the images Merge on the screen.
-
- SLIDE-TYPE-ZEBRA
- This command makes the images form like a Zebra.
-
- SLIDE-TYPE-RANDOM
- This command uses random slide show effects.
-
-
-
- CENTER
- This command centers the image on the screen
-
- FLIP
- This command flips the image on the screen
-
- GRAY
- This command turns the image into a Black & White (B&W)
- picture.
-
- INVERT
- NEGATIVE
- These commands make the pictures look like a negative. The
- colors are reversed.
-
- MIRROR
- This command mirror images the picture on the screen.
-
- ROTATE
- This command rotates the image clockwise on your screen.
-
- REDRAW
- This command redraws the image on the screen in case you had
- echoed some text on the screen and got rid of the picture.
-
- RES+
- RES-
- These commands increase and decrease the screen resolution in
- which the image is being displayed.
-
- PRINT
- This command prints the image to your printer. You must have
- an HP or EPSON compatible printer. The default printer
- configuration will be used to print all images. Make sure you
- have selected good default printer settings and have saved
- them with the ALT-U command from the main files list menu.
-
- WRITE {B,G,P,C} {1,2,3,filename}
- This command writes the current image to a file. If NO
- parameters are given, the current file format is used and the
- same name is used. If you specify "B" or "G" or "P" or "C"
- then a BMP or GIF or PCX or PIC will be written out to the
- same filename. For Example:
-
- WRITE B
-
- This would cause the current image displayed to be written out
- as a BMP file. This is great for converting files over to a
- different format!
-
- NOTE: If you select "G" without "filename" for a GIF file, you
- will NOT be able to add comments to the GIF file. If the GIF
- file had comments in it already, these would be kept in the
- file. If you use "filename", specify a file in the GIF-REED
- directory that contains the comments you want to add to the
- GIF file. For example:
-
- WRITE G MYNOTES
-
- This would force the image to have, as comments, the
- information in the file called MYNOTES located in the GIF-REED
- directory. If the name of the file had .ADD as an extension,
- the comments would be added to any comments that may currently
- be in the file. For example:
-
- WRITE G MYNOTES.ADD
-
- This would keep any old comments in the original GIF file and
- add to them the text in the file called MYNOTES.ADD. If you
- want to INSERT your personal comments IN FRONT of any comments
- currently in the GIF file, you can use a filename with an
- extension of .INS. For example:
-
- WRITE G MYNOTES.INS
-
- This would insert the text found in MYNOTES.INS and insert
- before any comments found in the original GIF file.
-
- HINT HINT HINT
-
- It may not be readily apparent, but you can actually REMOVE
- all comments from GIF files by specifying a filename without
- any data in it. Then use the "WRITE G FILENAME" command in the
- script language. This would remove any current comments and
- add whatever text is in FILENAME (nothing of course).
-
-
- NOTE: If you select "P" or "C" for PCX or PIC file, a default
- of 256 color mode will be used to create the file. In order to
- specify 2 or 16 color mode, you can use the SECOND parameter
- of a 1,2 or 3. For example:
-
- WRITE P 2
-
- This will write out a PCX file in 16 color mode. 1 indicates
- black and white (2 color mode). 2 indicates 16 color mode and
- 3 indicates 256 color mode.
-
- LESS-RED (While viewing CTRL-F1)
- MORE-RED (While viewing CTRL-F2)
- LESS-GREEN (While viewing CTRL-F3)
- MORE-GREEN (While viewing CTRL-F4)
- LESS-BLUE (While viewing CTRL-F5)
- MORE-BLUE (While viewing CTRL-F6)
- LESS-CONTRAST (While viewing CTRL-F7)
- MORE-CONTRAST (While viewing CTRL-F8)
- DARKER (While viewing CTRL-F9)
- BRIGHTER (While viewing CTRL-F10)
- LESS-REDDER (While viewing SHIFT-F1)
- MORE-REDDER (While viewing SHIFT-F2)
- LESS-GREENER (While viewing SHIFT-F3)
- MORE-GREENER (While viewing SHIFT-F4)
- LESS-BLUER (While viewing SHIFT-F5)
- MORE-BLUER (While viewing SHIFT-F6)
-
- All of these commands alter the appearance of the image on the
- screen. You should be able to figure out what each command
- does.
-
- RESET-COLORS
- If you turned the image into B & W with the GRAY command or
- used the color alter commands above, you can reset the colors
- to the ORIGINAL colors with this command.
-
- SORT-COLORS
- SORT-COLORS allows you to sort the image's color-map. It sorts
- the color map with the most frequently used colors at the
- front of the color map. This is great for images being
- displayed in Windows because Windows GRABS the TOP 4-16 colors
- in every image's color map for display purposes. This produces
- FUNNY looking pictures if the picture used a lot of a
- particular color that Windows took and changed to its own
- liking! By sorting the color map, the least used colors are
- placed at the top. In fact, a lot of images don't use the full
- 256 colors available in the color map. This means most images
- wouldn't be disturbed by Windows because the colors used by
- Windows would be colors in the color map that weren't even
- used by the image!
-
- ADJUST-FOR-WINDOWS
- This command will take the current image (picture) file and
- strip off the TOP 16 colors in the image's color table. The
- colors in the image that used the TOP 16 colors in the color
- table will be substituted with the BEST match in the lower 240
- colors in the color table. This produces results that are very
- close to the original image. A file processed by this command
- can then be used as a BMP file that Windows can use and
- display without distorting the image. The distortion that
- normally occurs when viewing a picture under Windows is
- because Windows will CHANGE the TOP 16 colors in the color
- table (map) of the image! By having the image NOT use the TOP
- 16 colors, the image will NOT be distorted while viewing under
- Windows!
-
- PRINTER Filename
- The filename given forces all printer output to go to the file
- instead of the printer. LPT1, LPT2 or PRN can be used as
- filenames to revert back to printer output. The default
- directory for the filename is in the current directory.
-
- PRINTER-ON
- This command turns on the printer. Anything that gets
- displayed on the screen (except images) will be printed to
- your printer. Things such as debug information, ECHO and
- DISPLAY items will be printed to your printer as well as being
- displayed on your screen.
-
- PRINTER-OFF
- This turns off the printer-on command.
-
- PRINTER-FF
- This command forces a Form-Feed on your printer. This means
- the last page will be ejected from your printer.
-
-
-
- MOUSE-CONTROL-ON
- This turns on mouse control. When mouse control is ON, images
- are left on the screen until you click a mouse button.
-
- MOUSE-CONTROL-OFF
- This turns off the mouse control. Images are finished
- displaying after the specified time delays are reached.
-
-
- DEBUG-ON
- This command turns on the debug mode. Every line in the script
- is shown on the screen as the script is being executed. Also,
- useful information about your 10 variables are displayed.
-
- DEBUG-OFF
- This command turns OFF the debug mode.
-
-
- BEEP ###
- This command causes a beep to be heard. If you indicate a
- NUMBER, you will hear that many beeps.
-
- DELAY ###
- This indicates how many seconds to delay before going to the
- next picture.
-
- ENTER
- This command forces the user to press ENTER or RETURN.
-
- SYSTEM {DOS COMMAND}
- This command allow you to execute a DOS command. NOTE: If no
- parameter is specified then you will be SHELLED out to DOS.
- You will need to type EXIT at the DOS prompt to continue with
- the script file.
-
- TEXT
- This puts the screen into TEXT mode, if it isn't already.
-
- WAIT ###
- This command waits for ### hundredths of a seconds. For
- example: "WAIT 500" would wait for 5 seconds and "WAIT 50"
- would wait for 1/2 a second.
-
-
-
- RES ###
- This command indicates the current resolution to be displayed
- if res-locking is turned ON. NOTE: If a number larger than the
- number of possible resolutions is used, the largest resolution
- will be selected.
-
- RES-LOCK
- This forces all further images to load with the specified
- resolution from "RES" to be used.
-
- RES-UNLOCK
- This forces res-locking off. This is the default state and all
- images are displayed with the BEST resolution used.
-
- RES-UP
- This command increments the resolution that would be used for
- res-locking.
-
- RES-DOWN
- This command decrements the resolution that would be used for
- res-locking.
-
- EGA-MODE
- This command forces the picture to be loaded in EGA mode. This
- produces POOR results compared to VGA mode. You probably
- shouldn't ever use this command unless you plan on converting
- your 256 color images to 16 color EGA images.
-
- VGA-MODE
- This command forces the picture to be loaded in VGA mode. This
- is the default, unless you only have EGA capability.
-
- EGA-COLOR-ADJUST {ON,OFF}
- When viewing a picture in EGA mode, the normal process is to
- convert all of the colors into 16 color selection. This makes
- the picture viewable in EGA mode even though the picture may
- be a 256 color image. This is the normal mode of operation.
- However, if you only have EGA capability and wish to perform a
- script file that manipulates the picture (Gray scale, rotate,
- mirror, etc...) and then saves it back out, you may NOT want
- the colors adjusted. In order to preserve the VGA quality of
- the colors while operating the script on a machine with EGA
- only capability, you may want to use the "EGA-COLOR-ADJUST
- OFF" statement. This way you can process your files on a EGA
- system without losing the VGA quality of the picture!
-
- KEEP-SCREEN-SIZE {ON,OFF}
- When using the WRITE command to write out GIF or PCX files,
- the original screen size is overwritten with whatever
- resolution mode you happen to be displaying the picture in.
- This means if you load a picture in a VGA system that only
- supports 320x200, when you go to write the GIF or PCX file,
- the 320x200 mode information is written to the file to
- indicate that it is to be displayed in 320x200 mode. This is
- NOT particularly good since the picture may be a 1024x768
- picture. In this case, any viewer would set the mode to
- 320x200 and then display the picture. This means you won't see
- the whole picture! If you use the "KEEP-SCREEN-SIZE ON"
- statement, when the picture is written to a GIF or PCX file,
- the ORIGINAL screen size is kept intact. This means you can
- process and convert your images to GIF or PCX files on a VGA
- system with only 320x200 resolution and NOT have to worry
- about how the picture will load with image viewers. The same
- goes for older super VGA cards that only support 640x480.
- Basically, if your card doesn't support the resolution the
- picture was INTENDED to be displayed in, you should use the
- "KEEP-SCREEN-SIZE ON" statement if you plan on writing out GIF
- or PCX files.
-
- NOTE: BMP files do NOT have this problem!. This is because BMP
- files DON'T save the INTENDED RESOLUTION into the file.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- READ-THIS-NOW
- This little bit of text should be helpful in getting started
- in the script command language. If you don't understand a
- command, just point to the command in the Context-Help screen
- and press RETURN. A complete description of the command will
- pop-up on your screen.
-
- For commands that have LABELS, such as GOTO and GOSUB and
- others, the LABEL MUST start with a colon ":". For example:
-
- GOTO :EXIT <This is a valid statement>
-
- GOTO EXIT <This statement is NOT valid>
-
- You can only put one (1) command per line. For example:
-
- FLIP MIRROR ROTATE <This is NOT valid>
-
- FLIP
- MIRROR
- ROTATE <This is the correct way>
-
- You should look at the sample script files that comes with
- GIF-REED. They are "A" through "W". X, Y and Z are not used
- as of yet. As a matter of fact, you can take "A" through "W"
- and modify (edit) them so that they do things completely
- different than what they originally were intended to do.
- It's really up to you as to what your script files should
- do for you.
-
- The kinds of things that you can do with script files are:
-
- 1. Specialized Slide Shows
- 2. Batch conversion of graphics files
- 3. Batch report files
- 4. Batch printing of picture files
- 5. Batch addition of comments to GIF files
- 6. Things I probably haven't thought of yet
-
- END-OF-HELP
-
-